home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 September / PCWorld_2002-09_cd.bin / Software / Vyzkuste / httrack / httrack-3.20RC4.exe / {app} / src / htshelp.c < prev    next >
C/C++ Source or Header  |  2002-05-26  |  23KB  |  602 lines
  1. /* ------------------------------------------------------------ */
  2. /*
  3. HTTrack Website Copier, Offline Browser for Windows and Unix
  4. Copyright (C) Xavier Roche and other contributors
  5.  
  6. This program is free software; you can redistribute it and/or
  7. modify it under the terms of the GNU General Public License
  8. as published by the Free Software Foundation; either version 2
  9. of the License, or any later version.
  10.  
  11. This program is distributed in the hope that it will be useful,
  12. but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. GNU General Public License for more details.
  15.  
  16. You should have received a copy of the GNU General Public License
  17. along with this program; if not, write to the Free Software
  18. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  19.  
  20.  
  21. Important notes:
  22.  
  23. - We hereby ask people using this source NOT to use it in purpose of grabbing
  24. emails addresses, or collecting any other private information on persons.
  25. This would disgrace our work, and spoil the many hours we spent on it.
  26.  
  27.  
  28. Please visit our Website: http://www.httrack.com
  29. */
  30.  
  31.  
  32. /* ------------------------------------------------------------ */
  33. /* File: httrack.c subroutines:                                 */
  34. /*       command-line help system                               */
  35. /* Author: Xavier Roche                                         */
  36. /* ------------------------------------------------------------ */
  37.  
  38. #include "htshelp.h"
  39.  
  40. /* specific definitions */
  41. #include "htsbase.h"
  42. #include "htscoremain.h"
  43. #include "htscatchurl.h"
  44. #include "htslib.h"
  45. #include "htsalias.h"
  46. #include <stdio.h>
  47. #include <stdlib.h>
  48. #include <string.h>
  49. #if HTS_WIN
  50. #else
  51. #include <unistd.h>
  52. #endif
  53. /* END specific definitions */
  54.  
  55. #define waitkey if (more) { char s[4]; printf("\nMORE.. q to quit\n"); linput(stdin,s,4); if (strcmp(s,"q")==0) quit=1; else printf("Page %d\n\n",++m); }
  56. void infomsg(char* msg) {
  57.   int l=0;
  58.   int m=0;
  59.   int more=0;
  60.   int quit=0;
  61.   int done=0;
  62.   //
  63.   if (msg==NULL)
  64.     quit=0;
  65.   if (msg) {
  66.     if (!quit) {
  67.       if (strlen(msg)==1) {
  68.         if (msg[0]=='1') {
  69.           more=1;
  70.           return;
  71.         }
  72.       }
  73.  
  74.       /* afficher alias? */
  75.       if (((int)strlen(msg)) > 4) {
  76.         if (msg[0]==' ') {
  77.           if (msg[2]!=' ') {
  78.             if ((msg[3]==' ') || (msg[4]==' ')) {
  79.               char cmd[32]="-";
  80.               int p=0;
  81.               while(cmd[p]==' ') p++;
  82.               sscanf(msg+p,"%s",cmd+strlen(cmd));
  83.               /* clears cN -> c */
  84.               if ((p=strlen(cmd))>2)
  85.                 if (cmd[p-1]=='N')
  86.                   cmd[p-1]='\0';
  87.               /* finds alias (if any) */
  88.               p=optreal_find(cmd);
  89.               if (p>=0) {
  90.                 /* fings type of parameter: number,param,param concatenated,single cmd */
  91.                 if (strcmp(opttype_value(p),"param") == 0)
  92.                   printf("%s (--%s[=N])\n",msg,optalias_value(p));
  93.                 else if (strcmp(opttype_value(p),"param1") == 0)
  94.                   printf("%s (--%s <param>)\n",msg,optalias_value(p));
  95.                 else if (strcmp(opttype_value(p),"param0") == 0)
  96.                   printf("%s (--%s<param>)\n",msg,optalias_value(p));
  97.                 else
  98.                   printf("%s (--%s)\n",msg,optalias_value(p));
  99.                 done=1;
  100.               }
  101.             }
  102.           }
  103.         }
  104.       }
  105.  
  106.       /* sinon */
  107.       if (!done)
  108.         printf("%s\n",msg);
  109.       l++;
  110.       if (l>20) {
  111.         l=0;
  112.         waitkey;
  113.       }
  114.     }
  115.   }
  116. }
  117. void help_wizard(httrackp* opt) {
  118.   char urls[HTS_URLMAXSIZE*2];
  119.   char mainpath[256];
  120.   char projname[256];
  121.   char stropt[2048];     // options
  122.   char stropt2[2048];    // options longues
  123.   char strwild[2048];    // wildcards
  124.   //
  125.   char str[256];
  126.   char* a;
  127.   //
  128.   strcpy(stropt,"-");
  129.   mainpath[0]=projname[0]=stropt2[0]=strwild[0]='\0';
  130.   //
  131.   
  132.   printf("\n");
  133.   printf("Welcome to HTTrack Website Copier (Offline Browser) "HTTRACK_VERSION"\n");
  134.   printf("Copyright (C) Xavier Roche and other contributors\n");
  135. #ifdef _WIN32
  136.   printf("Note: You are running the commandline version,\n");
  137.   printf("run 'WinHTTrack.exe' to get the GUI version.\n");
  138. #endif
  139. #ifdef HTTRACK_AFF_WARNING
  140.   printf("NOTE: "HTTRACK_AFF_WARNING"\n");
  141. #endif
  142. #ifdef HTS_PLATFORM_NAME
  143. #if USE_BEGINTHREAD
  144.   printf("[compiled: "HTS_PLATFORM_NAME" - MT]\n");
  145. #else
  146.   printf("[compiled: "HTS_PLATFORM_NAME"]\n");
  147. #endif
  148. #endif
  149.   printf("To see the option list, enter a blank line or try httrack --help\n");
  150.   //
  151.   // Project name
  152.   while(strnotempty(projname)==0) {
  153.     printf("\n");
  154.     printf("Enter project name :");
  155.     fflush(stdout);
  156.     linput(stdin,projname,250);
  157.     if (strnotempty(projname)==0)
  158.       help("httrack",1);
  159.   }
  160.   //
  161.   // Path
  162.   if (strnotempty(hts_gethome()))
  163.     printf("\nBase path (return=%s/websites/) :",hts_gethome());
  164.   else
  165.     printf("\nBase path (return=current directory) :");
  166.   linput(stdin,str,250);
  167.   if (!strnotempty(str)) {
  168.     strcat(str,hts_gethome());
  169.     strcat(str,"/websites/");
  170.   }
  171.   if (strnotempty(str))
  172.   if ((str[strlen(str)-1]!='/') && (str[strlen(str)-1]!='\\'))
  173.     strcat(str,"/");
  174.   strcat(stropt2,"-O \""); strcat(stropt2,str); strcat(stropt2,projname); strcat(stropt2,"\" ");
  175.   // CrΘer si ce n'est fait un index.html 1er niveau
  176.   make_empty_index(str);
  177.   //
  178.   printf("\n");
  179.   printf("Enter URLs (separated by commas or blank spaces) :");
  180.   fflush(stdout);
  181.   linput(stdin,urls,250);
  182.   if (strnotempty(urls)) {
  183.     while( (a=strchr(urls,',')) )  *a=' ';
  184.     while( (a=strchr(urls,'\t')) ) *a=' ';
  185.     
  186.     // Action
  187.     printf("\nAction:\n");
  188.     switch(help_query("Mirror Web Site(s)|Mirror Web Site(s) with Wizard|Just Get Files Indicated|Mirror ALL links in URLs (Multiple Mirror)|Test Links In URLs (Bookmark Test)|Update/Continue a Mirror",1)) {
  189.     case 1: break; 
  190.     case 2: strcat(stropt,"W"); break;
  191.     case 3: strcat(stropt2,"--get "); break;
  192.     case 4: strcat(stropt2,"--mirrorlinks "); break;
  193.     case 5: strcat(stropt2,"--testlinks "); break;
  194.     case 6: strcat(stropt2,"--update "); break;
  195.     case 0: return; break;
  196.     }
  197.       
  198.     // Proxy
  199.     printf("\nProxy (return=none) :");
  200.     linput(stdin,str,250);
  201.     if (strnotempty(str)) {
  202.       while( (a=strchr(str,' ')) ) *a=':';    // port
  203.       if (!strchr(jump_identification(str),':')) {
  204.         char str2[256];
  205.         printf("\nProxy port (return=8080) :");
  206.         linput(stdin,str2,250);
  207.         strcat(str,":");
  208.         if (strnotempty(str2)==0)
  209.           strcat(str,"8080");
  210.         else
  211.           strcat(str,str2);
  212.       }
  213.       strcat(stropt2,"-P "); strcat(stropt2,str); strcat(stropt2," ");
  214.     }
  215.     
  216.     // Display
  217.     strcat(stropt2," -%v ");
  218.  
  219.     // Wildcards
  220.     printf("\nYou can define wildcards, like: -*.gif +www.*.com/*.zip -*img_*.zip\n");
  221.     printf("Wildcards (return=none) :");
  222.     linput(stdin,strwild,250);
  223.     
  224.     // Options
  225.     do {
  226.       printf("\nYou can define additional options, such as recurse level (-r<number>), separed by blank spaces\n");
  227.       printf("To see the option list, type help\n");
  228.       printf("Additional options (return=none) :");
  229.       linput(stdin,str,250);
  230.       if (strfield2(str,"help")) {
  231.         help("httrack",2);
  232.       } else if (strnotempty(str)) {
  233.         strcat(stropt2,str);
  234.         strcat(stropt2," ");
  235.       }
  236.     } while(strfield2(str,"help"));
  237.     
  238.     {
  239.       char cmd[2048];
  240.       char *argv[256];
  241.       int argc=1;
  242.       int g=0;
  243.       int i=0;
  244.       //
  245.       printf("\n");
  246.       if (strlen(stropt)==1)
  247.         stropt[0]='\0';    // aucune
  248.       sprintf(cmd,"%s %s %s %s",urls,stropt,stropt2,strwild);
  249.       printf("---> Wizard command line: httrack %s\n\n",cmd);
  250.       printf("Ready to launch the mirror? (Y/n) :");
  251.       fflush(stdout);
  252.       linput(stdin,str,250);
  253.       if (strnotempty(str)) {
  254.         if (!((str[0]=='y') || (str[0]=='Y')))
  255.           exit(0);
  256.       }
  257.       printf("\n");
  258.  
  259.       // couper en morceaux
  260.       argv[0]="winhttrack";
  261.       argv[1]=cmd;
  262.       argc++;    
  263.       while(cmd[i])  {
  264.         if(cmd[i]=='\"') g=!g;
  265.         if(cmd[i]==' '){
  266.           if(!g){
  267.             cmd[i]='\0';
  268.             argv[argc++]=cmd+i+1;
  269.           }
  270.         }  
  271.         i++;
  272.       }
  273. #if HTS_ANALYSTE
  274.       hts_main(argc,argv);
  275. #else
  276.       main(argc,argv);
  277. #endif
  278.     }
  279.   //} else {
  280.   //  help("httrack",1);
  281.   }
  282. }
  283. int help_query(char* list,int def) {
  284.   char s[256];
  285.   char* a;
  286.   int opt;
  287.   int n=1;
  288.   a=list;
  289.   while(strnotempty(a)) {
  290.     char* b = strchr(a,'|');
  291.     if (b) {
  292.       char str[256];
  293.       str[0]='\0';
  294.       //
  295.       strncat(str,a,(int) (b - a));
  296.       if (n==def)
  297.         printf("(enter)\t%d\t%s\n",n++,str);
  298.       else
  299.         printf("\t%d\t%s\n",n++,str);
  300.       a=b+1;
  301.     } else
  302.       a=list+strlen(list);
  303.   }
  304.   printf("\t0\tQuit");
  305.   do {
  306.     printf("\n: ");
  307.     fflush(stdout);
  308.     linput(stdin,s,250);
  309.   } while ((strnotempty(s)!=0) && (sscanf(s,"%d",&opt)!=1));
  310.   if (strnotempty(s))
  311.     return opt;
  312.   else
  313.     return def;
  314. }
  315.  
  316. // Capture d'URL
  317. void help_catchurl(char* dest_path) {
  318.   char adr_prox[HTS_URLMAXSIZE*2];
  319.   int port_prox;
  320.   T_SOC soc=catch_url_init_std(&port_prox,adr_prox);
  321.   if (soc!=INVALID_SOCKET) {
  322.     char url[HTS_URLMAXSIZE*2];
  323.     char method[32];
  324.     char data[32768];
  325.     url[0]=method[0]=data[0]='\0';
  326.     //
  327.     printf("Okay, temporary proxy installed.\nSet your browser's preferences to:\n\n");
  328.     printf("\tProxy's address: \t%s\n\tProxy's port: \t%d\n",adr_prox,port_prox);
  329.     //
  330.     if (catch_url(soc,url,method,data)) {
  331.       char dest[HTS_URLMAXSIZE*2];
  332.       int i=0;
  333.       do {
  334.         sprintf(dest,"%s%s%d",dest_path,"hts-post",i);
  335.         i++;
  336.       } while(fexist(dest));
  337.       {
  338.         FILE* fp=fopen(dest,"wb");
  339.         if (fp) {
  340.           fwrite(data,strlen(data),1,fp);
  341.           fclose(fp);
  342.         }
  343.       }
  344.       // former URL!
  345.       {
  346.         char finalurl[HTS_URLMAXSIZE*2];
  347.         escape_check_url(dest);
  348.         sprintf(finalurl,"%s"POSTTOK"file:%s",url,dest);
  349.         printf("\nThe URL is: \"%s\"\n",finalurl);
  350.         printf("You can capture it through: httrack \"%s\"\n",finalurl);
  351.       }
  352.     } else
  353.       printf("Unable to analyse the URL\n");
  354. #ifdef _WIN32
  355.     closesocket(soc);
  356. #else
  357.     close(soc);
  358. #endif
  359.   } else
  360.     printf("Unable to create a temporary proxy (no remaining port)\n");
  361. }
  362.  
  363. // CrΘer un index.html vide
  364. void make_empty_index(char* str) {
  365. #if 0
  366.   if (!fexist(fconcat(str,"index.html"))) {
  367.     FILE* fp=fopen(fconcat(str,"index.html"),"wb");
  368.     if (fp) {
  369.       fprintf(fp,"<!-- "HTS_TOPINDEX" -->"CRLF);
  370.       fprintf(fp,"<HTML><BODY>Index is empty!<BR>(File used to index all HTTrack projects)</BODY></HTML>"CRLF);
  371.       fclose(fp);
  372.     }
  373.   }
  374. #endif
  375. }
  376.  
  377. // mini-aide  (h: help)
  378. //           y
  379. void help(char* app,int more) {
  380.   infomsg("");
  381.   if (more)
  382.     infomsg("1");
  383.   if (more != 2) {
  384.     char info[2048];
  385.     infomsg("HTTrack version "HTTRACK_VERSION" (compiled "__DATE__")");
  386. #ifdef HTTRACK_AFF_WARNING
  387.     infomsg("NOTE: "HTTRACK_AFF_WARNING);
  388. #endif
  389.     sprintf(info,"\tusage: %s <URLs> [-option] [+<FILTERs>] [-<FILTERs>]",app);
  390.     infomsg(info);
  391.     infomsg("\twith options listed below: (* is the default value)");
  392.     infomsg("");
  393.   }
  394.   infomsg("General options:");
  395.   infomsg("  O  path for mirror/logfiles+cache (-O path_mirror[,path_cache_and_logfiles])");
  396. #ifndef HTS_WIN
  397.   infomsg(" %O  chroot path to, must be r00t (-%O root_path)");
  398. #endif
  399.   infomsg("");
  400.   infomsg("Action options:");
  401.   infomsg("  w *mirror web sites");
  402.   infomsg("  W  mirror web sites, semi-automatic (asks questions)");
  403.   infomsg("  g  just get files (saved in the current directory)");
  404.   infomsg("  i  continue an interrupted mirror using the cache");
  405.   infomsg("  Y   mirror ALL links located in the first level pages (mirror links)");
  406.   infomsg("");
  407.   infomsg("Proxy options:");
  408.   infomsg("  P  proxy use (-P proxy:port or -P user:pass@proxy:port)");
  409.   infomsg(" %f *use proxy for ftp (f0 don't use)");
  410.   infomsg("");
  411.   infomsg("Limits options:");
  412.   infomsg("  rN set the mirror depth to N (* r9999)");
  413.   infomsg(" %eN set the external links depth to N (* %e0)");
  414.   infomsg("  mN maximum file length for a non-html file");
  415.   infomsg("  mN,N'                  for non html (N) and html (N')");
  416.   infomsg("  MN maximum overall size that can be uploaded/scanned");
  417.   infomsg("  EN maximum mirror time in seconds (60=1 minute, 3600=1 hour)");
  418.   infomsg("  AN maximum transfer rate in bytes/seconds (1000=1KB/s max)");
  419.   infomsg(" %cN maximum number of connections/seconds (*%c10)");
  420.   infomsg("  GN pause transfer if N bytes reached, and wait until lock file is deleted");
  421.   infomsg("");
  422.   infomsg("Flow control:");
  423.   infomsg("  cN number of multiple connections (*c8)");
  424.   infomsg("  TN timeout, number of seconds after a non-responding link is shutdown");
  425.   infomsg("  RN number of retries, in case of timeout or non-fatal errors (*R1)");
  426.   infomsg("  JN traffic jam control, minimum transfert rate (bytes/seconds) tolerated for a link");
  427.   infomsg("  HN host is abandonned if: 0=never, 1=timeout, 2=slow, 3=timeout or slow");
  428.   infomsg("");
  429.   infomsg("Links options:");
  430.   infomsg(" %P *extended parsing, attempt to parse all links, even in unknown tags or Javascript (%P0 don't use)");
  431.   infomsg("  n  get non-html files 'near' an html file (ex: an image located outside)");
  432.   infomsg("  t  test all URLs (even forbidden ones)");
  433.   infomsg(" %L <file> add all URL located in this text file (one URL per line)");
  434.   infomsg("");
  435.   infomsg("Build options:");
  436.   infomsg("  NN structure type (0 *original structure, 1+: see below)");
  437.   infomsg("     or user defined structure (-N \"%h%p/%n%q.%t\")");
  438.   infomsg("  LN long names (L1 *long names / L0 8-3 conversion / L2 ISO9660 compatible)");
  439.   infomsg("  KN keep original links (e.g. http://www.adr/link) (K0 *relative link, K absolute links, K4 original links, K3 absolute URI links)");
  440.   infomsg("  x  replace external html links by error pages");
  441.   infomsg(" %x  do not include any password for external password protected websites (%x0 include)");
  442.   infomsg(" %q *include query string for local files (useless, for information purpose only) (%q0 don't include)");
  443.   infomsg("  o *generate output html file in case of error (404..) (o0 don't generate)");
  444.   infomsg("  X *purge old files after update (X0 keep delete)");
  445.   infomsg(" %p  preserve html files 'as is' (identical to '-K4 -%F \"\"')");
  446.   infomsg("");
  447.   infomsg("Spider options:");
  448.   infomsg("  bN accept cookies in cookies.txt (0=do not accept,* 1=accept)");
  449.   infomsg("  u  check document type if unknown (cgi,asp..) (u0 don't check, * u1 check but /, u2 check always)");
  450.   infomsg("  j *parse Java Classes (j0 don't parse)");
  451.   infomsg("  sN follow robots.txt and meta robots tags (0=never,1=sometimes,* 2=always)");
  452.   infomsg(" %h  force HTTP/1.0 requests (reduce update features, only for old servers or proxies)");
  453.   infomsg(" %B  tolerant requests (accept bogus responses on some servers, but not standard!)");
  454.   infomsg(" %s  update hacks: various hacks to limit re-transfers when updating (identical size, bogus response..)");
  455.   infomsg(" %A  assume that a type (cgi,asp..) is always linked with a mime type (-%A php3,cgi=text/html;dat,bin=application/x-zip)");
  456.   infomsg("     shortcut: '--assume standard' is equivalent to -%A "HTS_ASSUME_STANDARD);
  457.   infomsg("");
  458.   infomsg("Browser ID:");
  459.   infomsg("  F  user-agent field (-F \"user-agent name\")");
  460.   infomsg(" %F  footer string in Html code (-%F \"Mirrored [from host %s [file %s [at %s]]]\"");
  461.   infomsg(" %l  preffered language (-%l \"fr, en, jp, *\"");
  462.   infomsg("");
  463.   infomsg("Log, index, cache");
  464.   infomsg("  C  create/use a cache for updates and retries (C0 no cache,C1 cache is prioritary,* C2 test update before)");
  465.   infomsg("  k  store all files in cache (not useful if files on disk)");
  466.   infomsg(" %n  do not re-download locally erased files");
  467.   infomsg(" %v  display on screen filenames downloaded (in realtime) - * %v1 short version");
  468.   infomsg("  Q  no log - quiet mode");
  469.   infomsg("  q  no questions - quiet mode");
  470.   infomsg("  z  log - extra infos");
  471.   infomsg("  Z  log - debug");
  472.   infomsg("  v  log on screen");
  473.   infomsg("  f *log in files");
  474.   infomsg("  f2 one single log file");
  475.   infomsg("  I *make an index (I0 don't make)");
  476.   infomsg(" %I  make an searchable index for this mirror (* %I0 don't make)");
  477.   infomsg("");
  478.   infomsg("Expert options:");
  479.   infomsg("  pN priority mode: (* p3)");
  480.   infomsg("      0 just scan, don't save anything (for checking links)");
  481.   infomsg("      1 save only html files");
  482.   infomsg("      2 save only non html files");
  483.   infomsg("     *3 save all files");
  484.   infomsg("      7 get html files before, then treat other files");
  485.   infomsg("  S  stay on the same directory");
  486.   infomsg("  D *can only go down into subdirs");    
  487.   infomsg("  U  can only go to upper directories");
  488.   infomsg("  B  can both go up&down into the directory structure");
  489.   infomsg("  a *stay on the same address");
  490.   infomsg("  d  stay on the same principal domain");
  491.   infomsg("  l  stay on the same TLD (eg: .com)");
  492.   infomsg("  e  go everywhere on the web");
  493.   infomsg(" %H  debug HTTP headers in logfile");
  494.   infomsg("");
  495.   infomsg("Guru options: (do NOT use is possible)");
  496.   infomsg(" #0  Filter test (-#0 '*.gif' 'www.bar.com/foo.gif')");
  497.   infomsg(" #f  Always flush log files");
  498.   infomsg(" #FN Maximum number of filters");
  499.   infomsg(" #h  Version info");
  500.   infomsg(" #K  Scan stdin (debug)");
  501.   infomsg(" #L  Maximum number of links (-#L1000000)");
  502.   infomsg(" #p  Display ugly progress information");
  503.   infomsg(" #P  Catch URL");
  504.   infomsg(" #R  Old FTP routines (debug)");
  505.   infomsg(" #T  Generate transfer ops. log every minutes");
  506.   infomsg(" #u  Wait time");
  507.   infomsg(" #Z  Generate transfer rate statictics every minutes");
  508.   infomsg(" #!  Execute a shell command (-#! \"echo hello\")");
  509.   infomsg("");
  510.   infomsg("Command-line specific options:");
  511.   infomsg("  V execute system command after each files ($0 is the filename: -V \"rm \\$0\")");
  512.   infomsg(" %U run the engine with another id when called as root (-%U smith)");
  513.   /* infomsg(" %O do a chroot before setuid"); */
  514.   infomsg("");
  515.   infomsg("Details: Option N");
  516.   infomsg("  N0 Site-structure (default)");
  517.   infomsg("  N1 HTML in web/, images/other files in web/images/");
  518.   infomsg("  N2 HTML in web/HTML, images/other in web/images");
  519.   infomsg("  N3 HTML in web/,  images/other in web/");
  520.   infomsg("  N4 HTML in web/, images/other in web/xxx, where xxx is the file extension (all gif will be placed onto web/gif, for example)");
  521.   infomsg("  N5 Images/other in web/xxx and HTML in web/HTML");
  522.   infomsg("  N99 All files in web/, with random names (gadget !)");
  523.   infomsg("  N100 Site-structure, without www.domain.xxx/");
  524.   infomsg("  N101 Identical to N1 exept that \"web\" is replaced by the site's name");
  525.   infomsg("  N102 Identical to N2 exept that \"web\" is replaced by the site's name");
  526.   infomsg("  N103 Identical to N3 exept that \"web\" is replaced by the site's name");
  527.   infomsg("  N104 Identical to N4 exept that \"web\" is replaced by the site's name");
  528.   infomsg("  N105 Identical to N5 exept that \"web\" is replaced by the site's name");
  529.   infomsg("  N199 Identical to N99 exept that \"web\" is replaced by the site's name");
  530.   infomsg("  N1001 Identical to N1 exept that there is no \"web\" directory");
  531.   infomsg("  N1002 Identical to N2 exept that there is no \"web\" directory");
  532.   infomsg("  N1003 Identical to N3 exept that there is no \"web\" directory (option set for g option)");
  533.   infomsg("  N1004 Identical to N4 exept that there is no \"web\" directory");
  534.   infomsg("  N1005 Identical to N5 exept that there is no \"web\" directory");
  535.   infomsg("  N1099 Identical to N99 exept that there is no \"web\" directory");
  536.   infomsg("Details: User-defined option N");
  537.   infomsg("  %n Name of file without file type (ex: image)");
  538.   infomsg("  %N Name of file, including file type (ex: image.gif)");
  539.   infomsg("  %t File type (ex: gif)");
  540.   infomsg("  %p Path [without ending /] (ex: /someimages)");
  541.   infomsg("  %h Host name (ex: www.someweb.com)");
  542.   infomsg("  %M URL MD5 (128 bits, 32 ascii bytes)");
  543.   infomsg("  %Q query string MD5 (128 bits, 32 ascii bytes)");
  544.   infomsg("  %q small query string MD5 (16 bits, 4 ascii bytes)");
  545.   infomsg("     %s? Short name version (ex: %sN)");
  546.   infomsg("  %[param] param variable in query string");
  547.   infomsg("");
  548.   infomsg("Details: Option K");
  549.   infomsg("  K0  foo.cgi?q=45  ->  foo4B54.html?q=45 (relative URI, default)");
  550.   infomsg("  K                 ->  http://www.foobar.com/folder/foo.cgi?q=45 (absolute URL)");
  551.   infomsg("  K4                ->  foo.cgi?q=45 (original URL)");
  552.   infomsg("  K3                ->  /folder/foo.cgi?q=45 (absolute URI)");
  553.   infomsg("");
  554.   infomsg("Shortcuts:");
  555.   infomsg("--mirror      <URLs> *make a mirror of site(s) (default)");
  556.   infomsg("--get         <URLs>  get the files indicated, do not seek other URLs (-qg)");
  557.   infomsg("--list   <text file>  add all URL located in this text file (-%L)");
  558.   infomsg("--mirrorlinks <URLs>  mirror all links in 1st level pages (-Y)");
  559.   infomsg("--testlinks   <URLs>  test links in pages (-r1p0C0I0t)");
  560.   infomsg("--spider      <URLs>  spider site(s), to test links: reports Errors & Warnings (-p0C0I0t)");
  561.   infomsg("--testsite    <URLs>  identical to --spider");
  562.   infomsg("--skeleton    <URLs>  make a mirror, but gets only html files (-p1)");
  563.   infomsg("--update              update a mirror, without confirmation (-iC2)");
  564.   infomsg("--continue            continue a mirror, without confirmation (-iC1)");
  565.   infomsg("");
  566.   infomsg("--catchurl            create a temporary proxy to capture an URL or a form post URL");
  567.   infomsg("--clean               erase cache & log files");
  568.   infomsg("");
  569.   infomsg("--http10              force http/1.0 requests (-%h)");
  570.   infomsg("");
  571.   infomsg("");
  572.   infomsg("example: httrack www.someweb.com/bob/");
  573.   infomsg("means:   mirror site www.someweb.com/bob/ and only this site");
  574.   infomsg("");
  575.   infomsg("example: httrack www.someweb.com/bob/ www.anothertest.com/mike/ +*.com/*.jpg");
  576.   infomsg("means:   mirror the two sites together (with shared links) and accept any .jpg files on .com sites");
  577.   infomsg("");
  578.   infomsg("example: httrack www.someweb.com/bob/bobby.html +* -r6");
  579.   infomsg("means get all files starting from bobby.html, with 6 link-depth, and possibility of going everywhere on the web");
  580.   infomsg("");
  581.   infomsg("example: httrack www.someweb.com/bob/bobby.html --spider -P proxy.myhost.com:8080");
  582.   infomsg("runs the spider on www.someweb.com/bob/bobby.html using a proxy");
  583.   infomsg("");
  584.   infomsg("example: httrack --update");
  585.   infomsg("updates a mirror in the current folder");
  586.   infomsg("");
  587.   infomsg("example: httrack --continue");
  588.   infomsg("continues a mirror in the current folder");
  589.   infomsg("");
  590.   infomsg("HTTrack version "HTTRACK_VERSION" (compiled "__DATE__")");
  591.   infomsg("Copyright (C) Xavier Roche and other contributors");
  592. #ifdef HTS_PLATFORM_NAME
  593.   infomsg("[compiled: "HTS_PLATFORM_NAME"]");
  594. #endif
  595.   infomsg(NULL);
  596.  
  597. //  infomsg("  R  *relative links (e.g ../link)\n");
  598. //  infomsg("  A   absolute links (e.g /www.adr/link)\n");
  599. }
  600.  
  601.  
  602.